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Section 1 
GENERAL INFORMATION 



1.1 INTRODUCTION 

This document contains information about the DNCS/SNA Batch 

(SBLU) product, release l.O.O, that is not contained in the 

standard documentation associated with the object installation 
kit. 

Subjects discussed in this document are special features or 
considerations that may be important for the proper installation 
and operation of the object package. 



1.2 UPDATE INFORMATION 

This is the first release of SBLU. There is no update 
information. 



1.3 MEMORY REQUIREMENTS 

Because SBLU uses features already available in the DNCS Job, it 
does not increase the memory used by the DNCS Job, except for the 
addition of a station for SBLU in the DNCS configuration. 

The SBLU Job consists of a shared procedure and seven tasks. The 
procedure and all of the tasks are reliable. BLURDR, BLUPUN, 
BLUPRT, and BLUOPR tasks are bid only when the associated SBLU 
function is active, and they terminate when that function is 
completed. The other tasks are bid when the SBLU Job is started, 
and remain bid during the life of the Job. The following table 
describes the amount of memory required by each of the tasks in 
the SBLU Jobs 
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Name 



Size (bytes ) 



Type 



Program file 



BLUCS 


11648 


proc 


< d n c s 


vo 1 >. S*DNCS. PGMTASK 


BLUMGR 


43656 


task 


< dries 


vo 1 > . S*DNCS . PGMTASK 


BLUCON 


7066 


task 


<dncs 


vo 1 >. S*DNCS. PGMTASK 


BLULOG 


7552 


task 


<dncs 


vo 1 > . SSDNCS . PGMTASK 


BLURDR 


S242 


task 


<dncs 


vo 1 > . S«DNCS . PGMTASK 


BLUPUN 


6883 


task 


<dncs 


vo 1 >. S*DNCS. PGMTASK 


BLUPRT 


9130 


task 


<dncs 


vo 1 >. S*DNCS. PGMTASK 


BLUOPR 


12612 


task 


<dncs 


vo 1 > . S*DNCS . PGMTASK 



1.4 DNOS BUFFER TABLE AREA REQUIREMENTS 

The SBLU Job never has more than two I/O operations issued to the 
DNCS IPC channel at one time. Support of these two operations 
requires 540 bytes of DNOS buffer table area. SBLU mar use 
additional buffer table area as required to support SBLU I/O 
operations to DNOS I/O resources. 



1.5 



START-UP PROCEDURES 



You must start both DNCS and SBLU before Jobs can be transmitted 
between SBLU and your application. If you want SBLU started each 
time the computer system is initial ized* you can include the 
XDNCS and XBLU SCI commands in the DNOS initialization batch 
stream .S*ISBTCH. 



1-2 
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Se c t i o n 2 

KNOWN PROBLEMS 

This section documents known problems that mav be encountered in 
install ins and operating the SBLU object package. 



2. 1 SOFTWARE 



1. The SBLU operator program (BLUOPR) does not detect 
termination of the SBLU Job until you attempt to enter 
a command from the terminal at which BLUOPR is running. 
When the ENTER key is pressed to pass information to 
the SBLU Job from the BLUOPR command entry line* BLUOPR 
terminates. The following message appears in the log 
display area: 

SBLU0903 E SVC ERROR <xxxx>, BLUOPR CANNOT ACCESS 
SBLU JOB, PRESS CMD TO EXIT 

The SVC error code is indicated by the value of <xxxx>. 

2. When the SBLU log file contains less than twenty lines, 
the BLUOPR page forward operation (requested via the Fl 
function key) causes one or more lines to be repeated 
in the log display area. You can clean up the log 
display area by pressing the F3 function key. 

3. The SBLU log file may occasionally contain DNCS 
messages that are either out of sequence or 
inconsistent with current conditions in the SBLU Job. 
Ignore any DNCS messages that conflict with SBLU 
messages. 

4. The SBLU terminal command TRACE, which controls 
operation of the SBLU event trace facility, does not 
detect or report any errors which may occur during 
assignment of the trace logical unit number or use of 
the I/O resource associated with the trace file. 

5. STR 19411 - SBLU does not recover properly after 
rejecting an invalid access name specified with an 
EXECUTE terminal command, or an invalid access name 
specified with a SEND terminal command in a stored Job 
procedure. Subsequent EXECUTE and SEND commands are 
rejected. You can recover from this problem by 
terminating and restarting the SBLU Job. 
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6. STR 19412 - If the RESUME terminal command is used to 
resume a previously suspended inbound data stream? SBLLI 
processes the resumed data stream as application 
command data? regardless of the original data stream 
type. 

7. STR 19414 - The CANCEL terminal command is accepted, 
but has no effect? for outbound data streams. 

3. STR 19415 - If the SDLC data link is broken while SBLU 
is processing a DNCS SVQ request, the following message 
is sent to the SBLU log file: 

SBLU0403 I SVQ <<w^> RECORD <rrrr> DELETED 

This message normally indicates that the service queue 
request identified by record number <rrrr> has been 
removed from subqueue <qqq>. In this case, you should 
ignore this message. The service queue request remains 
in subqueue <qqq>? and is processed when the SDLC link 
is reestablished. 

9. STR 19416 - SBLU is occasionally slow in completing 
requests. In these cases? processing is always 
completed normally after a slight delay. 



2.2 DOCUMENTATION 

Messages produced by SBLU SCI command procedures that are not 
documented in the DNOS_DNCSZSNfi_Ba±ch_Usecls_Gu.Lde. are documented 
here. 



2.2.1 QBLU (Enqueue SBLU Execute) Messages 

The following messages have been defined for the QBLU SCI 
commands 



ERROR: TRANSMISSION TIME MUST NOT EXCEED 2359 

Explanation: 

The value specified for TRANSMISSION TIME indicates a 
time later than 2359? which is not allowed on a 24-hour 
cl ock. 

User Action: 

Reenter the QBLU command with a valid transmission 
time. 



•">_ ^> 
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ERROR: FILE PATHNAME DOES NOT EXIST 

Explanations 

The value specified for ACCESS NAME is not a valid DNOS 
I/O resource name. 

User Action: 

Reenter the QBLU command with a valid access name. 



ERROR: SBLU<qq> SERVICE QUEUE REQUEST FAILED 

ExpI anation: 

QBLU was not able to enqueue this request in the DNCS 
service queue (SVQ) on subqueue number <iq>. This 
usually indicates that the DNCS SVQ file has not been 
created. the subsueue status is either not ACTIVE or 
not ACCEPT, or the DNCS SVQ file is full. 

User Action: 

Use the DNCS SVQ utility QMGR, described in the DNOS 
DNCS-OEacatiiana-Guide, to display service queue status. 
If the REQUEST SPACES AVAILABLE count equals zero, the 
service queue is full and you must wait for space to 
become available. Other types of problems may be 
corrected via QMGR functions described in the DfcJQS 
DNCS_OEe.ca±iflEis._Guide. . 



SBLU<qq> SERVICE QUEUE REQUEST SUCCESSFULLY ENTERED 

ExpI anation: 

Your request has been successfully entered in the DNCS 
SVQ file on subqueue number <qq>. 

User Action: 

No action is required. 



o ■-> o 



TBLU (Terminate SBLU Emulator) Messages 



The following messages have been defined for the TBLU SCI 
command: 



DNCS SBLU EMULATOR TERMINATED, JOB= BLU<sss> 

ExpI anation: 

The SBLU Job for station ID <sss> has been successfully 
terminated. 

User Action: 

No action is required. 
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SBLU TERMINATION ERROR <nnnn> 

Exp! ana t ion: 

SCI error <nnnn> was encountered during termination of 
the SBLU Job. 

User Actions 

Check the DNOS_M£££asa£_and_Co.de.s_E'e.£e.n£HCfi_.fcJaBual to 
determine the exact problem and user action. 



2.2.3 XBLU (Execute SBLU Emulator) Messages 

The following messages have been defined for the XBLU SCI 
commands 



TIP ACCESS NAME DOES NOT EXIST 

Explanation! 

The value specified for TIP ACCESS NAME is not a valid 
DNOS I/O resource name. 

User Action: 

Reenter the XBLU command with a valid terminal 
initialization procedure (TIP) access name. 



**** SBLU STATION BLU<sss> ALREADY ACTIVE 

Explanation: 

An SBLU Job has already been started for station ID 
<sss>. 

User Action! 

No action is required. If necessary? you can use the 
SCI command TBLU to terminate the SBLU Job for station 
ID <sss>» then reenter the XBLU command. 



2-4 2539080-9901** 



DNCS/SNA Batch Release Information Patches and Patch procedures 



Section 3 
PATCHES AND PATCH PROCEDURES 



3. 1 PATCH UPDATE PROCEDURE 



Patches are maintained bv Texas Instruments and are available to 
customers from two sources - Customer Support Line and Patch 
Update Service. The Customer Support Line is able to provide 
patches on an as needed basis over the telephone or bv 
communications link. Call (51 2) -250-7407 to set the latest patch 
files. Periodical 1y, Texas Instruments will ship all current 
patches for the DNOS svstem familY software to customers on the 
subscription service. Refer to the DNOS Products Patch Update 
Service Release Information for a list of the latest patches. In 
both cases, a detailed explanation will be provided on how to 
apply the patches to vour svstem. 

It is recommended that you call the Customer Support Line to set 
the latest patches prior to installation of the product. 
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